Copyright ã1995 by NeXT Computer, Inc.  All Rights Reserved.

NXPort

Inherits From:	NXInvalidationNotifier : Object

Conforms To:	NXReference (through NXInvalidationNotifier)
NXTransport (Distributed Objects)

Declared In:	machkit/NXPort.h

Class Description

The NXPort class provides an object-oriented interface to Mach ports.  NXPort objects are used by the Distributed Objects system whenever a Mach port is needed. 

Instance Variables

port_t machPort;

machPort	The Mach port managed by the NXPort

Adopted Protocols

NXReference	- addReference
- free
- references

NXTransport	- encodeRemotelyFor:freeAfterEncoding:isBycopy:
- encodeUsing:
- decodeUsing:

Method Types

Creating an NXPort	+ new
+ newFromMachPort:
+ newFromMachPort:dealloc:

Freeing an NXPort	- free

Listening for port deaths	+ worryAboutPortInvalidation

Getting the Mach port	- machPort

Hash-table value for the port	- hash

Class Methods

new

+ new

Creates and returns a new NXPort instance.  This method allocates a new Mach port that will be deallocated when the instance is freed.

See also:  + newFromMachPort:, + newFromMachPort:dealloc:

newFromMachPort:

+ newFromMachPort:(port_t)port

Creates and returns a new NXPort instance that wraps an existing port specified by port.  port will not be deallocated when the instance is freed.

See also:  + new, + newFromMachPort:dealloc:

newFromMachPort:dealloc:

+ newFromMachPort:(port_t)port dealloc:(BOOL)flag

Creates and returns a new NXPort instance that wraps an existing port specified by port.  If flag is YES, port will be deallocated when the instance is freed; otherwise, it won't be deallocated.

See also:  + new, + newFromMachPort:

worryAboutPortInvalidation

+ worryAboutPortInvalidation

Forks a thread to listen for port deaths; this thread sleeps until a port dies.  If a port death occurs, any objects registered for invalidation notification receive a senderIsInvalid: message.  This is generally only useful in applications that don't use the Application Kit.

See also:  - senderIsInvalid: (NXSenderIsInvalid protocol)

Instance Methods

free

- free

Decrements the receiver's reference count, returning self if the reference count remains greater than 0.  If the reference count becomes 0, this method deallocates the receiver's storage and returns nil.

See also:  NXReference protocol

hash

- (unsigned int)hash

Returns a hash-table index for the NXPort.  This isn't generally useful.

machPort

- (port_t)machPort

Returns the NXPort's Mach port.  This can be useful if you need to pass the port to routines that deal with Mach ports rather than NXPorts.